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Accept 

/ACCEPT [[-] nick, ...] /MODE <your nick> <+|->g 
Works only in some IRC networks. 

ACCEPT allows you to specify who you want to receive private messages and notices from while you 
are in callerid (+g) mode. When you have user mode +g enabled, messages from other users are 
blocked and the sender is notified; you are also notified but at most once per minute. IRC operators 
and services can usually send through +g. 

The accept list is lost when you disconnect. Users are automatically removed from the accept list if 
they quit, split or change nick. 

The argument is a comma-separated list of nicks to add or (when prefixed with a '-') to remove. No 
output is returned for users successfully added or removed. If no arguments are given, your accept 
list is displayed (ACCEPT * on the protocol level). 

Example: / ACCEPT user 1 , user 2 , - use r3 , -user4- Adds userl and user2 and removes user3 
and user4. 

See also: IGNORE, SILENCE 

Action 

/ACTION [-<server tag>] <target> <message> 

Same as ME, but gets channel or nick as an additional parameter. Example: /ACTION #irssi 
yawns (This outputs the following to #i rssi : * Nick yawns) 

See also: ME 



Admin 

/ADMIN [<server> | <nickname>] 

Displays the administrative details about the given server. If no server is specified, the server you are 
connected to is used. If a nickname is supplied then it gives the administrative information for that 
person's current server. 



6 



Alias 



/ALIAS [[-]<alias> [<command>] ] 

Creates a new alias or shows matching defined aliases. Without parameters shows all defined aliases. 
Multiple commands can be run if separated with ';' character. Parameters given to alias are in $0..$9 
variables, if you don't use them in your alias, all parameters are automatically appended after it. 

Examples: 

/ALIAS w - shows all defined aliases starting with letter w. 

/ALIAS send echo Sending file $1 to $0;dcc send $0- - creates alias 'send'. 
/ALIAS -send - removes alias 'send'. 
See also: UNALIAS 

Away 

/AWAY [-one | -all] [<reason>] 

This command marks you as being "away". It is used to tell people that you currently aren't pay- 
ing attention to your screen. You might use it if you are taking a nap, in the shower, getting some 
food, or otherwise just aren't there at the moment. When you're "away" you will see "(zZzZ)" in your 
statusbar. 

Anyone who does a WHOIS on your nickname will see that you are away, as well as your away mes- 
sage. Anyone doing a WHO that returns information about you will also see that you're gone. 

By default, if someone sends you a MSG while you are away, your client will beep. You can turn this 
off by setting BEEP_WHEN_AWAY to OFF. 

If you send a MSG to someone who is away, you will automatically be notified of this. By default, you 
will only receive this notification once. If you wish to see it every time (to tell when a person is no 
longer marked away, for instance), change SHOW_AWAY_ONCE to OFF. 

You can remove your away status by using AWAY with no arguments. 

See also: SET AWAY 
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Ban 

/BAN [<channel>] [<nicks>] /BAN [-normal | -user | -host | -domain 
-custom <type>] <ni cks/masks> 

Bans the specified nick or userhost mask. 

If nick is given as parameter, the ban type is used to generate the ban mask. /SET ban_type 
specifies the default ban type. Ban type is one of the following: 

Normal - * ! *user@* . domai n . net 

User - *!*user@* 

Host - *! *@host . domai n . net 

Domain - *! *@* . domai n . net 

Custom [nick] [user] [host] [domain] 

If no arguments are given the current bans in this channel are displayed. 
Examples: 

/BAN loser - Bans the nick 'loser' 

/BAN -host loser - Bans the host of nick 'loser' 

/BAN * ! *@* . org - Bans all the users coming from any .org domain. 

/SET ban_type custom nick domain - ni ck ! *@* . domai n . net 

/SET ban_type custom user host - *! user@host . domai n . net 

See also: KNOCKOUT, KICKBAN 

Beep 

/BEEP 

Outputs the bell-character, usually causing your terminal beep. 
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Bind 



/BIND [-list] [-delete] [<key> [<command> [<data>]] 

Bind some action to specified keystroke. Remember that all characters in keystrokes are case- 
sensitive! Uppercase letter usually means that you need to keep SHIFT pressed to get the key to 
work. 

Most most commonly used keystrokes are: 



A X - Ctrl-X 

meta-x - Meta-x (Meta is quite often Alt-key in PCs, ESC-x works too) 



Irssi has by default also defined several other keys which you can use: 



return 

space, backspace 

up, down, left, right 

cleft, cright 

home, end, prior, next 

insert, delete 



The return/enter key 
Space / backspace 
Arrow keys 
Ctrl-left/right 
prior = Page Up, next 



Page Down 



The keystroke can contain as many key presses as you want, and you can define names for differ- 
ent key sequences to use them more easily (the keys above are done like that). For example, you 
may want to manage windows with " W key, so that "W" C creates new window, "W" K kills the active 
window, etc. you may do it like: 

/BIND "W"C /WINDOW NEW HIDE /BIND "W"K /WINDOW KILL 

But maybe you wish to give these binds to other people who want to use some other key than " W, 
then it would be better done as: 

/BIND "W key window /BIND window-"C /WINDOW NEW HIDE /BIND window-"K 
/WINDOW KILL To get a list of all bindable commands use /bi nd -list. 

Examples: 

Clearscreen: /BIND meta-c /CLEAR 

People with qwertz layout probably want to swap meta-y and meta-z: 

/BIND meta-z change_wi ndow 16 /BIND -delete meta-y 
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Cat 

/CAT <file> 

Outputs the contents of the specified file. Equivalent to UNIX cat command. 
See also: CD 

CD 

/CD <directory> 

Changes the current working directory. Equivalent to UNIX cd command. 
See also: DCC GET 

Channel 

/CHANNEL LIST /CHANNEL ADD [-auto | -noauto] [-bots <masks>] [-botcmd 
<command>] <channel> <network> [<password>] /CHANNEL REMOVE <channel> 
<network> 

Irssi can automatically join to specified channels in specified IRC networks. It can also automatically 
send the password when manually joining to channel without specifying the password. 

/CHANNEL ADD [-auto | -noauto] [-bots <masks>] [-botcmd <command>] 
<channel> <network> [<password>] 

With - bots and - botcmd arguments you can automatically send commands to someone in chan- 
nel. This is useful for automatically getting ops for channels, for example 

/CHANNEL ADD -auto -bots "* ! bot@bothost . org bot* ! *@host2 . org" -botcmd 
"msg $0 op mypass" #channel i rcnet 

You can also use the - botcmd without - bots argument. The command is then sent whenever you 
join the channel. 

If you want to remove some settings from existing channel record, for example bots, just give the 
-bots "" parameters to it. Password can be removed by setting it to - (or actually, "" works too). 

You can remove the channels with /CHANNEL REMOVE <channel> <network> 
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/CHANNEL LIST displays list of channels with settings. 

/CHANNEL without any arguments displays list of channels you have joined. You can also use /CHAN- 
NEL to join to channels just as with /JOIN, like /CHANNEL #a. 

See also: TS, JOIN 



Clear 



/CLEAR [-all] [<refnum>] 

This command clears the current window of all text. It is useful for wiping a screen that has rendered 
improperly (such as due to a bad termcap entry) or that contains sensitive information (such as one's 
OPER password). 



Completion 



Irssi can "complete" some words for you - you can write just first few letters of the word and press 
TAB (or any other key with action word_completion assigned). Then, irssi will choose the most prob- 
able matching word and inserts it to the command line. You can press TAB repetitively and irssi will 
replace the chosen word with another possible words matching to the letters you wrote. 

The words chosen usually depend on their context - they can be filenames or command names, but 
most frequently they are nicks of people on same channels as you are. However, you can have global 
list of own completions, which apply to all contexts. This command is dedicated to maintaining of 
such a list. 

Without any parameters, /COMPLETION displays list of all user completions. 

/COMPLETION [-auto] <prefix> <stri ng> adds completion which gets triggered when 
you press TAB (or any other key with action word_completion assigned) after writing <prefix> 
specified and which expands to <stri ng>. When -auto is specified, the completion gets triggered 
even when you press SPACE or ENTER (or any other key with action check_replaces assigned) after 
the <pref i x>. If there's already some <pref ix> completion in the list, it will get replaced. 

/COMPLETION -delete <pref i x> removes completion of <prefix> from the user comple- 
tion list. 

Note: When -auto is specified for the <prefix> you want to remove you have to quote it like 
/COMPLETION -delete ' <prefi x> '. (Works with double quotes as well.) 

See also: BIND 



Connect 



/CONNECT [-4 -6] [-ssl] [-ssl_cert <cert>] [-ssl_pkey <pkey>] 
[-ssl_veri fy] [-ssl_cafile <cafile>] [-ssl_capath <capath>] [-!] 
[-noautosendcmd] [-noproxy] [-network <network>] [-host <hostname>] 
[-rawlog <file>] <address> | <chatnet> [<port> [<password> [<nick>] ] ] 



-4, -6: specify explicitly whether to use IPv4 or IPv6 address 
-ssl: use SSL when connecting 

-ssl_cert: The SSL client certificate file (implies -ssl) 

-ssl_pkey: The SSL client private key (if not included in the certificate file) 
-ssl_verify: Verify servers SSL certificate 

-ssl_cafile: File with list of CA certificates (implies -ssl_verify) 



11 



-ssl_capath: Directory with CA certificates (implies -ssl_verify) 

-network: the network this connection belongs to 

-ircnet: Same as -network. Deprecated. Do not use. 

-host: the host 

-!: don't autojoin channels 

-noautosendcmd : don't execute autosendcmd 

-rawlog: immediately open rawlog after connected 

This command makes irssi connect to specified server. Current connections are kept and a new one 
is created. 

See also: SERVER, DISCONNECT, RMRECONNS, SCONNECT 

CTCP 

/CTCP <targets> <ctcp command> [<ctcp data>] 

Sends a CTCP message. For example CTCP ACTION, or CTCP VERSION. 

See also: ME, ACTION 

Cycle 

/CYCLE [<channel>] [<message>] 

Cycles (leaves and joins) the current channel or the specified channel. 
See also: JOIN, PART 
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Dec 

/DCC CHAT [-passive] [<nick>] /DCC GET [<nick> [<file>]] /DCC RESUME 
[<nick> [<f i le>] ] /DCC SERVER [+|-scf] [port] /DCC CLOSE <type> <nick> 
[<file>] 

/DCC LIST - Shows all the open DCC connections. 

/DCC RESUME [<nick> [<fi le>] ]- Resumes a DCC SEND/GET connection. 

/DCC CHAT [-passive] [<nick>] - Sends a chat connection request to remote client or 
accepts a chat connection if the remote end has already sent a request. If -passive is used then the 
passive DCC protocol is used (as mIRC can do). This is useful to bypass a NAT/firewall which limit your 
possibility in listening for remote connections. 

/DCC GET [<nick> [<fi le>] ]- Gets the file offered by remote client. The file is downloaded 
and saved into the directory specified by the 'dcc_download_path' setting. 

/DCC SEND [-passive] [-append | -prepend | -flush | -rmtail | -rmhead] 
<nick> <file> [<file> ...]- Sends a DCC SEND requestto remote client. Remote end has 
to accept the request before the transmission can be started. Giving multiple files queues them. File 
names may contain shell expansion characters: * ? [] ~ (-expansion may not besupported on all 
platforms). Files with spaces in their names need to be quoted (eg. "file name"). If -passive 
is used then the passive DCC protocol is used (as mIRC and xchat > 2.0.7 can do). This is useful to 
bypass a NAT/firewall which limit your possibility in listening for remote connections. 

/DCC SERVER [<+|-scf> <port>] - Starts a DCC SERVER on the specified port. The remote 
can connect to this server and initiate chat, send and fserve requests. You can specify + or - using 
any combination of the flags 's' (Send), 'c' (Chat), or 'f (Fserver). 

/DCC CLOSE <type> <nick> [<fi le>] - Closes a DCC-connection. Type can be eitherSEND, 
GET or CHAT. 

See also: CD 



Dehilight 

/DEHI LIGHT <id>|<mask> Removes the specified item from highlight list. 
See also: HILIGHT 
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Deop 

/DEOP <nicks> 

Takes off the channel operator privileges from the specified nick(s). 
Wildcards in the nick are allowed. 

See also: OP 

Devoice 

/DEVOICE <nicks> 

Takes off the voice from the specified nick(s). This makes them not to be able to send messages to 
the moderated (+m) channel. 

Wildcards in the nick are allowed. 

See also: VOICE, MODE 

Die 

/DIE 

IRC operator command. Terminates the IRC server. 
See also: OPER 

Disconnect 

/DISCONNECT * | <tag> [<message>] 

Disconnects from the specified IRC-server. The server tags can be seen with: /SERVER 
See also: CONNECT, SERVER 
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Echo 

/ECHO [-current] [-window <name>] [-level <level>] <text> 
Prints text into the current window. Useful for scripts. 

Eva I 

/EVAL <command(s)> 

Evaluates the given commands and executes them. Internal variables are expanded. See the 
speci al_va rs . txt file in the docs-directory. 



Exec 

/EXEC [-] [-nosh] [-out | -msg <target> | -notice <target>] [-name 
<name>] <cmd line> /EXEC -out | -window | -msg <target> | -notice 
<target> | -close | -<signal> 9o<id> /EXEC -in 9o<id> <text to send to 
process> 

-: Don't print "process terminated ..." message 

-nosh: Don't start command through /bin/sh 

-out: Send output to active channel/query 

-msg: Send output to specified nick/channel 

-notice: Send output to specified nick/channel as notices 

-name: Name the process so it could be accessed easier 

-window: Move the output of specified process to active window 
-close: Forcibly close (or "forget") a process that doesn't die. 

This only removes all information from i rssi concerning the 
process, it doesn't send SIGKILL or any other signal 
to the process. 

-<signal>: Send a signal to process. <signal> can be either numeric 
or one of the few most common ones (hup, term, kill, ...) 

-in: Send text to standard input of the specified process 
-interactive: Creates a query-like window item. Text written to it is 
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sent to executed process, like /EXEC -in. 



Execute specified command in background. Output of process is printed to active window by default, 
but can be also sent as messages or notices to specified nick or channel. 

Processes can be accessed either by their ID or name if you named it. Process identifier must always 
begin with 9696 character, like %96Q or JoKname. 

Once the process is started, its output can still be redirected elsewhere with the -window, -msg, etc. 
options. You can send text to standard input of the process with -in option. 

-close option shouldn't probably be used if there's a better way to kill the process. It is meant to 
remove the processes that don't die even with SIGKILL. This option just closes the pipes used to 
communicate with the process and frees all memory it used. 

/EXEC without any arguments displays the list of started processes. 
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Flushbuffer 

If eitherwri te_buf fer_timeout orwri te_buf f er_si ze have been set an immediate write 
of the buffers is forced. 

Format 

/FORMAT [-delete | -reset] [<module>] [<key> [<value>]] 
Allows you to view/change irssi's messages. Use this command with care. 
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Hash 

/HASH 

Not available. 

Help 

/HELP [<command>] 

Shows help on commands. Try: /HELP command 
Alsotry, for example: /SET beepor/SET auto 

Hilight 

/HILIGHT [-nick | -word | -line] [-mask | -full | -regexp] [-color 
<color>] [-actcolor <color>] [-level <level>] [-channels <channels>] 
<text> 

-mask: Match only for nick, <text> is a nick mask 
-regexp: <text> is a regular expression 
-full: <text> must match to full words 

-nick: Hilight only the nick, not the whole line (default) 
-word: Hilight only the word (default with non-public messages) 
-line: Hilight the whole line with the hilight color, 
-color: Print the message with <color>. color is in %%code format 

(see docs/formats . txt) 
-actcolor: Color to show in statusbar activity, or don't change if %%n. 
-level: Match only for <level> messages, default is 

publi cs ,msgs , noti ces , actions 
-channels: Match only in <channels> (comma separated list) 
-priority: Priority to use when multiple hilights match. Default is 0. 

Examples: 

Hilight lines that have "mynick" word: /HILIGHT mynick 
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H i light all messages from "mynick": /HI LIGHT -mask mynick!*@* 

Hilight lines that were written by nicks from * . f i with bold green /HI LIGHT -color %%G 
-mask *!*@*.fi 

For regular expressions, see man 7 regex. 
See also: DEHI LIGHT, SET HILIGHT 
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Ignore 

/IGNORE [-regexp | -full] [-pattern <pattern>] [-except] [-replies] 
[-network <network>] [-channels <channel>] [-time <secs>] <mask> 
[<levels>] 

/IGNORE [-regexp | -full] [-pattern <pattern>] [-except] [-replies] 
[-network <network>] [-time <secs>] <channels> [<levels>] 

-regexp: <pattern> is a regular expression 

-full: <pattern> must match to full words 

-pattern: <pattern> must match to the message's text 

-except: *DON'T* ignore - overrides an existing ignore. 

-replies: Ignore replies to nick in channels. For example 

"/IGNORE -replies *!*@*.fi PUBLIC" ignores everyone 
from Finland, but also anyone sending message 
"tofinnishnick: blahblah". 

-network: Ignore only on this network. 

-ircnet: Same as -network. Deprecated. Do not use. 

-channels: Ignore only in channels (comma separated list) 

-time: <secs> seconds after the ignore is removed 

<mask>: Either a nick mask or list of channels 

<levels>: List of levels to ignore. You can use -<level> to remove levels 

from ignore (/help levels for details). 
< A levels>: List of levels to NOT ignore 

(/ignore -except nick notices = /ignore nick ^notices) 

/IGNORE without any arguments displays list of ignores. If you want to remove some levels of the 
ignore, use /IGNORE <mask> -<level> -<level2>etc 

The best match always wins, so you can have: /IGNORE * CTCPS /IGNORE -except 
* ! *@host.org CTCPS 

Examples: 

/IGNORE * JOINS - ignore joins in all channels 

/IGNORE #channel ALL -PUBLIC -ACTIONS - ignore all but public/actions 
/IGNORE #channel -JOINS - don't ignore joins anymore 

/IGNORE -replies *! user@* . host . org ALL - ignore user and all replies 
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Some suggestions for ignoring annoying public aways: 

/IGNORE -regexp -pattern "is (away | gone | back) " * ACTIONS 
/IGNORE *zzz* NICKS 
/IGNORE *afk* NICKS 
/IGNORE *away* NICKS 

For regular expressions, see man 7 regex. 
See also: UNIGNORE, SILENCE, ACCEPT 

Info 

/INFO [<server>] 

Shows information about the IRC server software and the current server instance. 

Invite 

/INVITE <nick> [<channel>] 

Invites the specified nick to the current or specified channel. 

Example: /INVITE buddy #mychannel 

See also: MODE 

Invitelist 

/INVITELIST 

Shows the +1 modes of the current channel. +1 mode allows free joins of clients with certain userhost 
masks even if the channel is invite only. 

See also: INVITE, MODE 

Ircnet 

/IRCNET 

Deprecated. Use NETWORK instead. 

Ison 

/ISON <nicks> 

Tells whether specified nicks (space-separated) are online. 
See also: WHOIS, WHOWAS, NOTIFY 
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Join 

/JOIN [-window] [-invite] [-<server tag>] <channels> [<keys>] 

-window: Join channel, placing channel window item in currently active window 
-invite: Join last invited channel 

-<server tag>: Join channel on server with specified tag 

Joins a specified channel. Channel names usually begin with #-sign, which may be omitted here. 
JOIN is aliased to J by default. Example: /j irssi (This joins to the channel #irssi) 
See also: PART, WINDOW CLOSE 
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Kick 



/KICK [<channel>] <m'cks> [<reason>] 

This command "kicks" the specified user off of the specified channel. It is typically used to remove 
troublemakers, flooders, or people otherwise making a nuisance of themselves on the channel. The 
reason for the kick is recommended, but not required by the IRC servers. 

If the <channel> is omitted, removes the nick from the current channel. 

The default alias for /KICK is /K. 

See also: KNOCKOUT 



Kickban 

/KICKBAN [<channel>] <nicks> <reason> 

Kicks off and bansa nick from the current channel. A reason forthe kick can be supplied. 
Default alias for /KICKBAN is /KB. 
See also: KNOCKOUT, BANTYPE 



Kill 

/KILL <nick> <reason> 
IRC operator command. 

KILL is used to forcibly remote a client from the ire network. It works similarly to KICK, except that a 
reason must be given (even if it is meaningless or flat-out wrong). 

In general, KILL is useful only as a warning tool for abusive users. Modern ire clients (this one in- 
cluded) have automated means for reconnecting to a server after a disconnection (whether due to a 
KILL or something else), so KILL is by no means a permanent solution. It is not intended as a means 
for personal vendettas; this practice is generally frowned upon. 

See also: OPER 
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Knock 



/KNOCK <channel> 

Works only in some IRC networks (hybrid-like ircds). 

KNOCK is a feature that lets you request access to a channel they cannot join without an invite, a key 
or a raised limit. 

The following conditions must be met for KNOCK to work: 

• You are not banned from the channel 

• Channel is not private (+p) 

• You are not already on the channel 

• Channel is invite only (+i), has a key (+k) or limit is full 

When successful KNOCK is issued, it sends a notice to channel operators. Use of KNOCK is rate limited 
by the server. 



Knockout 

/KNOCKOUT [<time>] <nicks> <reason> 

Kicks user off the channel and bans him/her. Ban lasts the given number of seconds or 5 minutes by 
default. 

Default alias for /KNOCKOUT is /KN. 
See also: BAN, KICK 
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Lastlog 

/LASTLOG [-] [-file <filename>] [-window <ref#|name>] [-new | -away] 
[-<level> -<level...>] [-clear] [-count] [-case] [-regexp | -word] 
[-before [<#>]] [-after [<#>]] [-<# before+after>] [<pattern>] [<count> 
[<start>]] 

-clear: remove all lastlog lines from window 
-: don't print the "Lastlog:" and "End of Lastlog" messages, 
-file: write lastlog to file instead of screen 

-window: which window's lastlog to check (output is always to active) 
-case: Case-sensitive matching 

-force: Force displaying lastlog even if it's longer than 1000 lines 
-new: show only lines since last /LASTLOG 
-regexp: 'text' is a regular expression 
-word: 'text' must match to full words 

-<level>: levels to check (default is all; /help levels for details) 
<pattern>: text to search for, or all if empty 
<count>: maximum number of lines to show 
<start>: skip the last 'start' lines 

Shows the given number of lines of log from the current window. 



Layout 

/LAYOUT SAVE /LAYOUT RESET 

Saves the current window layout to configuration (yes, you'll still need to use /SAVE to save the config- 
uration to file). Next time you run irssi, all the channels and queries are exactly in the same windows 
where they were when you called /LAYOUT SAVE. 

Channels aren't actually joined in those windows immediately, they're just marked "next time you 
join to '#channel' in server that has tag 'ircnet' place it to this window". 

/ LAYOUT RESET removes the saved layout. 
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Levels 



Message levels (or in short, levels) are used almost everywhere. They describe what kind of messages 

we're dealing with. Here's a list of them all: 

CRAP - Can be almost anything 

MSGS - Private messages 

PUBLIC - Public messages in channel 

NOTICES - Notices 

SNOTES - Server notices 

CTCPS - CTCP messages 

ACTIONS - Actions (/me) - usually ORed with PUBLIC or MSGS 

JOINS - Someone joins a channel 

PARTS - Someone parts a channel 

QUITS - Someone quits IRC 

KICKS - Someone gets kicked from channel 

MODES - Channel mode is changed 

TOPICS - Channel topic is changed 

WALLOPS - Wallop is received 

INVITES - Invite is received 

NICKS - Someone changes nick 

DCC - DCC related messages 

DCCMSGS - DCC chat messages 

CLIENTNOTICE - Irssi's notices 

CLIENTERROR - Irssi's error messages 

CLIENTCRAP - Some other messages from Irssi 

And a few special ones that could be included with the levels above: 



HILIGHT 

NOHILIGHT 

NO_ACT 

NEVER 



Text is highlighted 

Don't check highlighting for this message 
Don't trigger channel activity when printing 
this message 

Never ignore or log this message 



Links 



/LINKS [[<server>] <mask>] 

Shows the links between the IRC servers of the current IRC network. If a wildcard parameter is spec- 
ified, shows only the matching entries. 

See also: MAP 



List 

/LIST [-yes] [<channel>] 

Lists the channel names. Trying to list all the channel names usually causes you to be disconnected 
from the server with the reason "Excess flood", as usually all 40000 channels form together and server 
naively attempts to send you them. 

Thus, on IRCNet, you should rather use service ALIS (Advanced Listing Service), which will allow you 
to query for channel with specific name, topic, mode or usercount. Type /SQUERY ALIS HELP to get 
more info about it. 
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See also: SQUERY 



Load 

/LOAD <module> [<submodule>] 

Load a plugin. If full path isn't given, irssi searches the plugin from directories: 

-/. i rssi /modules/ <install dir, /usr/local or /usr maybe>/lib/i rssi /modules/ 
See plugins page of http://www.irssi.org/to see if there's any plugins you'd want to use. 

To load a perl script you should use /SCRIPT. 

See also: UNLOAD 

Log 

/LOG OPEN [-noopen] [-autoopen] [-window] [-<server tag>] [-targets 
<targets>] [-colors] <fname> [<levels>] /LOG CLOSE <i d> | <f i le> /LOG 
START <id> | <file> /LOG STOP <id>|<file> 

-noopen: Create the entry to log list, but don't start logging 

-autoopen: Automatically open this log file at startup 

-<server tag> : Targets are logged only in this server 

-targets: Log only in specified channels/nicks (space separated list) 

-window: Log output in the window. Active window is used by default, or 

you can give the window's refnum in -targets. 
<filename>: File name where to log, it is parsed with 

strftimeQ, so %9od=day, etc. see "man strftime" for 

more info. 
<levels>: Defaults to ALL 
<id>: ID number of log. 

/SET log_create_mode <mode> - Specifies what file mode to use with the created log files. 
Default is 0600. 

All of these are parsed with strftime. 

/SET log_timestamp <text> - Specifies the time stamp format. Default is "%%H:%%M". 

/SET log_open_stri ng <text> -Text written to log when it's opened 

/SET log_close_stri ng <text> - Text written to log when it's closed 

/SET log_day_changed <text> -Text written to log when day changes 

NOTE: Log files are locked after opened, so two Irssis can't accidentally try to write to the same log 
file. 

Examples: 

/LOG OPEN -targets eras ~/i rclogs/cras . log MSGS - Logs all messages from/to nick 
'eras' 

/LOG OPEN -targets fflinux ~/i rclogs/li nux/li nux-9o%Y-9o9om-%96d - Logs all mes- 
sages in channel #linux. Log is rotated daily, so logs in 1. May 2000 goes to file "linux-2000-05-01", 
when the day is changed, Irssi closes the log and starts logging to "linux-2000-05-02" etc. 

See also: SET LOG, WINDOW LOG 
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Lusers 

/LUSERS [<server mask> [<remote server>]] 
Shows user statistics of the current IRC network. 
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Map 

/MAP 

Works only in some IRC networks and is often restricted to IRC operators. 
Shows a graphical map of the IRC network, often with user counts. 

Me 

/ME <message> 

Sends a CTCP ACTION to the current channel or query. For example: /me sits back. 
See also: ACTION, CTCP 

Mircdcc 

/MIRCDCC ON | OFF 

Selects whether to send mIRC style CTCPs in DCC chat session. 

If a ml RC user sends first a CTCP, mIRC style CTCPs is automatically selected for that DCC Chat session. 
See also: SET MIRC 

Mode 

/MODE <your ni ck> | <channel> [<mode> [<mode parameters>] ] 
Common channel modes are: 

i - Invite only - People can't join to channel without being 
/INVITEd, or being in invite list (+1, see below). 

m - Moderated - People who don't have voices (+v) can't send 
messages to channel 

p - Private - People who aren't joined to channel can't see it 
for example with /WHOISing people who are in channel. 
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s - Secret - Like private, but the channel isn't displayed in 
/LIST'S output. 

n - No external msgs - Without this mode, anyone can send messages 

to channel without even being joined, 
t - Topic can be changed only by channel operators. 

k <key> - Channel password (aka. key) - The channel can't be joined 
without specifying the channel key (see section 6.2). 

1 <count> - User limit - No more than <count> people can join to 

channel. This can be overridden with /INVITE with some 
servers . 

This is usually used for protecting channel from join 
flooding, like some bot allows max. 5 users to join in 
one minute or so. 

b - Set/remove ban. For example MODE #channel +b *!*@*.org bans 
everyone from .org domain. 

If someone from .org domain was already in channel before the 
ban was set, he/she cannot send any messages to channel (doesn't 
work with all servers) . 

Bans can also be overridden with /INVITE, although many stupid 
IRC clients automatically kick the user out because they see 
the ban and think that because of it the user shouldn't be in 
the channel (doesn't work with all servers). 

e - Ban exceptions. You could for example ban everyone from 

*!*@*.org but set ban exception to *! *@* . host . org - does not work 
with all servers. 

I - Invite list. If channel is invite only (+i), people in this 

list can join it without being /INVITEd - does not work with all 
servers . 

This is excellent for in-country channels that don't want 
foreigners (spammers!) to join the channel, for example setting 
channel's mode to +i and +1 *!*@*.fi allows only finnish people 
to join the channel. In addition to this, there's usually a bot 
in the channels and sending /MSG bot invite command to it 
/INVITEs you to the channel. 

On IRCnet, the ':' feature in channel names can also be used for 
a similar effect, see section 6.2. 

o <nick> - Grant or revoke channel operator status from nick 
v <nick> - Grant or revoke voice status from nick, only people with 
+v (or +o) can talk to channel when it's moderated (+m) . 

You can send multiple mode changes with one mode command: 

/MODE #channel +nto-o+v nickl nick2 nick3 

This would set channel's mode to +nt, give ops to nickl, take ops from nick2 and give voices to nick3. 
You can set only a limited number of modes that require an argument in one command. In IRCnet 
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it's 3, in EFnet it's 4 and in many others it's 6. If it's not known, Irssi defaults to 3. Irssi will also 
automatically split them, so you can use /MODE +000000 nl n2 ... command to op 6 people and Irssi 
will split it to two commands in IRCnet/EFnet. 

Many networks have additional modes and/or change the meaning of existing modes. Check the 
documentation for the network or the server software in use for details. 

See also: OP, DEOP, VOICE, DEVOICE, BAN, UNBAN 

Motd 

/MOTD [<server> | <nick>] 

Shows the motd of the current or specified server. This contains usually some useful info on the 
server, administrator and the rules. 

Msg 

/MSG [-<server tag>] [-channel | -nick] <targets> <message> 

Sends a message to a nick or a channel. Usually this is used for sending private messages to other 
persons. 

Examples: 

/MSG friend Hi, what's up? 

/MSG #irssi Hello, is the new gtk-version out already? (This format is rarely 
needed.) 

See also: CTCP 
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Names 

/NAMES [-count | -ops -halfops -voices -normal] [<channels> | **] 

-ops: show channel operators in list 
-halfops: show half operators in list 
-voices: show voiced people in list 
-normal: show rest of the people in list 

Shows the names (nicks) in the specified channels. /NAMES ** shows all nicks in all channels, you 
probably don't want to do this. 

Examples: 

/NAMES - shows nicks in the current channel. 

/NAMES -ops #cl , #c2 - shows operators in channels #cl and #c2 

See also: WHO, CHANNEL 

Nctcp 

/NCTCP <targets> <ctcp command> [<ctcp data>] 
Sends a CTCP reply notice to the nick/channel. 
See also: CTCP, ACTION, MSG, NOTICE 

Netsplit 

/NETSPLIT 

Irssi keeps track of people who were lost in net splits. With this command you can get a list of them. 
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Network 



/NETWORK ADD [-nick <nick>] [-user <user>] [-realname <name>] [-host 
<host>] [-autosendcmd <cmd>] [-querychans <count>] [-whois <count>] 
[-msgs <count>] [-kicks <count>] [-modes <count>] [-cmdspeed <ms>] 
[-cmdmax <count>] <name> 

NETWORK REMOVE <network> 

-kicks: Maximum number of nicks in one /KICK command 
-msgs: Maximum number of nicks in one /MSG command 
-modes: Maximum number of mode changes in one /MODE command 
-whois: Maximum number of nicks in one /WHOIS command 
-cmdspeed: Same as /SET cmd_queue_speed , see section 3.1 
-cmdmax: Same as /SET cmds_max_at_once, see section 3.1 
-nick, -user, -realname: Specify what nick/user/name to use 
-host: Specify what host name to use, if you have multiple 
-usermode: Specify what usermode to use on this network 
-autosendcmd: Command to send after connecting to a server 

With - autosendcmd argument you can automatically run any commands after connecting to net- 
work. This is useful for automatically identifying yourself to NickServ, for example 

Shows and changes the settings of defined IRC networks. 

See also: CONNECT 

Nick 

/NICK <new nick> 
Changes your nick. 



Note 

/NOTE <command> [&<password>] [+|-<flags>] [<arguments>] 

/NOTE is a sort of turbo-charged messaging system for ire. In short, it achieves at the server level 
what the client attempts to do with / MSG and /NOTIFY. The messaging system resembles modern 
voicemail systems (except in text); messages can be sent, stored, or set for deferred delivery. The 
client notification system works like / NOTIFY, except with greater accuracy and flexibility. 

The most common uses of /NOTE are its SPY and SEND functions. SPY is similar to NOTIFY, except 
it can accept a full address to spy on, not just a nickname. SEND, as its name implies, sends a note 
to a user; if that user is not currently online, it will be delivered if the user logs onto ire within a set 
time period. 

When referring to a particular user, NOTE can deal with the standard ni ck! user@host notation. 
Wildcards are allowed, and any portion may be omitted, so long as the identifier remains unambigu- 
ous. 

Examples: To send a note to Joebob (whose account isjbriggs@drivein.com): 

/NOTE SEND j oebob ! j bri ggs@d ri vei n . com Hey there! Great movie! 

To spy on anyone from blah.com for the next 30 days: 

/NOTE SPY +30 *!*@*. blah. com A blah.com user is active 
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This command is not available in the IRCNet. However, you've service NoteServ available there, 
which allows you to do similiar things like with /NOTE command on other IRC networks. Type 
/SQUERY NoteServ HELP to get more info about it. 

See also: NOTIFY, SQUERY 

Notice 

/NOTICE <targets> <message> 

Sends a notice to the nick or the channel. Usually notices are used in bots and scripts for different 
kinds of replies. The IRC protocol states that notices may not generate replies to avoid msg loops. 

See also: NCTCP, MSG 

Notify 

/NOTIFY [-away] <mask> [<ircnets>] 
-away: Notifies about away-status changes 

-list: Lists the notify list entries with all their settings 
<mask>: Either a simple "nick" or "ni ck ! *@*blah . org" . 
The nick can't contain wildcards, but the user/host can. 

/NOTIFY without any arguments displays if the people in notify list are online or offline. 
See also: UNNOTIFY, SET NOTIFY 
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Op 

/OP <nicks> 

Gives channel operator privileges to the specified nick(s). Wildcards in the nick are allowed. 
See also: DEOP, MODE, VOICE, DEVOICE, KICK 

Oper 

/OPER [<nick> [<password>] ] 

Gives you operator privileges if the correct nickname and password are given. If password is not 
given, you will be prompted for one. If no nickname is given, your current nickname will be used. 

See also: KILL, DIE 
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Part 

/PART [<channels>] [<message>] 

Parts from the current or specified channel. Depending on your settings, closes the corresponding 
window, too. 

See also: JOIN 



Ping 

/PING [<m'ck> | <channel> | *] 

Sends CTCP PING to another IRC client or to an IRC channel. This is used to find out the speed of IRC 
network. When the PING reply comes in, irssi shows the interval time between sending the request 
and receiving the reply. 

See also: CTCP 
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Query 

/QUERY [-window] [-<server tag>] <nick> [<message>] 

Starts a private conversation with the nick. AH text you type that would normally be sent to your 
channel now goes to the specified nick in the form of MSGs. 

Usually this command opens up a new window, too. 

Note: It removes the active query from the active window when used without parameters, like UN- 
QUERY. 

See also: WINDOW, MSG, SET QUERY, UNQUERY 

Quit 

/QUIT [<message>] 

This ends your IRC session. If a quit message is supplied, it will be displayed to anyone else on any 
channel you were on before quitting. If one isn't specified, the text "Leaving" is used. 

/EXIT does the same. 

Quote 

/QUOTE <data> 

Sends server raw data without parsing. 
Example: 

/QUOTE PRIVMSG eras :Hey, this works! 
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Rawlog 

/RAWLOG SAVE <fi le> /RAWLOG OPEN <fi le> /RAWLOG CLOSE 

All data that is received or sent to server is kept in a raw log buffer for a while. Also event redirections 
are kept there. This is very useful for debugging purposes. 

/RAWLOG SAVE <fi lename> - Save the current raw log bufferto file 

/RAWLOG OPEN <filename> - Like /RAWLOG SAVE, but keep the log file open and write all new 
log to it. 

/RAWLOG CLOSE -Close the open rawlog 

/SET rawlog_li nes <count> - Specify the number of raw log lines to keep in memory. 

Recode 

/RECODE /RECODE ADD [ [<tag>/] <target>] <charset> /RECODE REMOVE 
[<target>] 

/RECODE - List the conversion database 

/RECODE ADD [<tag>] ] [ [<tag>/] <target>] <charset> Add an entry to the conversion 
database (if tag or target is omitted, the current channel or query will be used). You can specify the 
to have different charsets for the same for different networks. You can omit the target, and specify 
only the tag if you want to add an entry for the network. 

/RECODE REMOVE [<tag> | <target>] Remove an entry from the conversion database (if tag 
or target is omitted, the current channel or query will be used) 

To specify your local charset you have to set te rm_cha rset 

Example: 

/SET term_charset <charset> 
To see the recode settings: /SET recode 
You can change them with /SET 
Examples: 

/SET recode OFF to turn off recode completely 

/SET recode_ fall back <charset>to set the fallback charset for incoming events 
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This charset is used if yourterm_charset is UTF-8 and the conversion for the target is not set and the 
text is not UTF-8. 

/SET recode_out_def ault_charset <charset>to set the global outgoing charset 

When it's set to a charset it will be used if no conversion for the target is set. 

/SET recode_transli terate ON to enable the global transliteration. 

The transliteration is based on your locale settings, if it doesn't work properly your locale settings 
may be wrong. You can enable it per target by adding //TRANSLIT to the 

/SET recode_autodetect_utf8 OFF to turn automatic UTF-8 detection off. 

Hint: can be almost everything listed by 'iconv -I' 

See also: NETWORK 

Reconnect 

/RECONNECT <tag> [<quit message>] 

You can reconnect to serverwith /RECONNECT <n>. 

/RECONNECT without any arguments will disconnect from the active server and reconnect back 
immediately. 

See also: SERVER, DISCONNECT, RMRECONNS 

Rehash 

/REHASH [<option>] 
IRC Operator command. 

This command is used to force the current server to reload its ircd.conf configuration file. This is 
useful for effecting configuration changes without starting a new server. 

Some servers have various types of rehashes, specified by an additional parameter. 

See also: OPER, RESTART 

Reload 

/RELOAD [<file>] 
Reloads irssi's configuration file. 
See also: SAVE 

Restart 

/RESTART 

IRC Operator command. 

This command is used to completely restart the server, breaking all connections. Aside effect of this 
is that the configuration file will be read again. However, it is generally more useful for upgrading the 
server software. 

See also: OPER, DIE 
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Rmreconns 



/RMRECONNS 

Removes the pending reconnections from the reconnect list. 
See also: CONNECT, RECONNECT, SERVER 

Rmrejoins 

/RMREJOINS 

Removes the pending rejoins from the channel rejoin list in active server. Channels are added to 
rejoin list when join failed because of netsplits in server ("Channel is temporarily unavailable"). 

See also: JOIN 

Rping 

/RPING <server> 

IRC Operator command, not available on all networks. 

This command works like the PING command (CTCP PING), except it is used on a server instead of a 
client. As with PING, it is used to test the relative distance another server is from you across the ire 
network. 

See also: OPER 
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Save 

/SAVE [<file>] 

- formats - Save all /FORMATS into theme file 

Saves the current Irssi configuration into the configuration file. 

See also: RELOAD 

Say 

/SAY <message> (alias for "/MSG *") 

The actual command used to put into the current channel. Avery useful command if you need aliases 
for often used phrases. 

For example: /alias brb say I'm off for a while, be right back. 
This would allow you to use /brb to put the "I'm off*" into the channel. 

Sconnect 

/SCONNECT <new server> [[<port>] <existing server>] 

IRC Operator command. Makes an IRC server connect to another server. This is CONNECT on the 
protocol level. 

See also: OPER, SQUIT, RESTART 

Script 

Irssi has very powerful support for scripts written in Perl - they can extend functionality of Irssi in 
almost unlimited way, and they still keep the client's core unbloated, light and fast. You can control 
loading and execution of such scripts by this command. 

Without any parameters, /SCRIPT acts in same way as if you would call /SCRIPT LIST. 

/SCRIPT LIST displays list of all currently loaded scripts, together with full path to their source 
files. 
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/SCRIPT EXEC executes the as a little perl script. It doesn't preserve it loaded in memory, unless 
-permanent is specified. 

/SCRIPT LOAD loads the 

in memory and executes it. 

/SCRIPT UNLOAD unloads the 

from memory. 

/SCRIPT RESET unloads all loaded scripts and resets the perl interpreter. 
See also: LOAD, UNLOAD 

Scrollback 

/SCROLLBACK CLEAR [-all] [<refnum>] /SCROLLBACK LEVELCLEAR [-all] 

[-level <level>] [<refnum>] /SCROLLBACK GOTO <+ | -li necount> | <linenum> | <timestamp> 

/SCROLLBACK HOME /SCROLLBACK END 

/SCROLLBACK, or the default alias/SB: 

/SB LEVELCLEAR - Remove lines with level matching one of those specified in the comma- 
separated list . 

/SB CLEAR- Clear screen, free all memory used by texts in window. 
/SB HOME -Jump to start of the buffer. 
/SB END- Jump to end of the buffer. 

/SB GOTO [ [- | +] line# | time] - Jump to specified line or timestamp. Time format is 
[dd[.mm] | -<days ago>] hh : mi [ : ss] . 

See also: SET SCROLL 

Server 

/SERVER [-4 | -6] [-ssl] [-ssl_cert <cert>] [-ssl_pkey <pkey>] 
[-ssl_veri fy] [-ssl_cafile <cafile>] [-ssl_capath <capath>] [-!] 
[-noautosendcmd] [-noproxy] [-network <network>] [-host <hostname>] 
[-rawlog <file>] [+] <address> | <chatnet> [<port> [<password> [<nick>]]] 

/SERVER REMOVE <address> [<port>] [<network>] 

/SERVER ADD [-4 | -6] [-ssl] [-ssl_cert <cert>] [-ssl_pkey <pkey>] 
[-ssl_veri fy] [-ssl_cafile <cafile>] [-ssl_capath <capath>] [-auto 
-noauto] [-network <network>] [-host <hostname>] [-cmdspeed <ms>] 
[-cmdmax <count>] [-port <port>] <address> [<port> [<password>] ] 

/SERVER LIST 

/SERVER PURGE [<target>] 

-4, -6: specify explicitly whether to use IPv4 or IPv6 address 
-ssl: use SSL when connecting 

-ssl_cert: The SSL client certificate file (implies -ssl) 

-ssl_pkey: The SSL client private key (if not included in the certificate file) 
-ssl_verify: Verify servers SSL certificate 

-ssl_cafile: File with list of CA certificates (implies -ssl_verify) 
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-ssl_capath: Directory with CA certificates (implies -ssl_verify) 
-noproxy: Ignore the global proxy configuration for this server 
-auto: Automatically connect to server at startup 
-noauto: Don't connect to server at startup (default) 
-network: Specify what IRC network this server belongs to 
-ircnet: Same as -network. Deprecated. Do not use 
-host: Specify what host name to use, if you have multiple 
-!: don't autojoin channels 
-noautosendcmd : don't execute autosendcmd 
-cmdspeed: Same as /SET cmd_queue_speed , see section 3.1 
-cmdmax: Same as /SET cmds_max_at_once , see section 3.1 
-port: Use this only to edit the port number of an existing server, 
for new servers use the <port> argument 

/SERVER disconnects the server in active window and connects to the new one. It will take the same 
arguments as /CONNECT. If you prefix the address with the + character, Irssi won't disconnect the 
active server, and it will create a new window where the server is connected (ie. /window new hide; 
/connect address) 

/SERVER without any arguments displays the list of connected servers. 
/SERVER REMOVE <address> [<port>] [<network>] 
/SERVER LIST 
/SERVER PURGE [<target>] 

Clears the server send queue. Useful if, for example, you accidentally paste lots of text to a channel. 
See also: CONNECT, DISCONNECT, RECONNECT, RMRECONNS 

Servlist 

/SERVLIST [<server mask>] 
Works only on IRCnet. 

/SERVLISTgives the list of services currently present on the IRC network. It can take two argu- 
ments: 

<mask> limits the output to the services which names matches the mask. 
<type> limits the output to the services of the specified type. 
The fields returned are: 

Service name. 

Server who introduced the service. 

Distribution mask. 

Service type. 

Hop count to the service. 

A comment. 

See also: SQUERY 
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Set 



/SET [-clear | -default] [<key> [<value>]] 
You can view or change the settings with /SET command. 

/SET without any arguments displays all the settings. /SET <key> displays settings whose key 
(partly) matches /SET <key> <value> sets to 

Boolean settings accept only values ON, OFF and TOGGLE. You can also use /TOGGLE command to 
change them, so /TOGGLE <key> behaves like /SET <key> TOGGLE. /TOGGLE also accepts 
arguments ON and OFF when /TOGGLE behaves exactly like /SET. 

Remember that changes are not saved until you use / SAVE! 

Examples: 

/SET autolog OFF -Sets value for setting 'autolog' 

/SET close - Shows all settings whose variable name contains 'close'. Very practical. 
See also: TOGGLE 

Silence 

/SILENCE [[+| -]<m'ck!user@host>] /SILENCE [<nick>] 
Works only in some IRC networks. 

SILENCE is similar in many respects to IGNORE, except that it is server-based. What this means is 
the server will never even send you messages from anyone you have silenced, whereas it will with 
IGNORE, where your client is responsible for filtering the messages out. This has the advantage of 
not bogging your client down with excessive data as it tries to filter out messages. The silence list is 
lost when you disconnect. SILENCE only affects private messages and invites. 

The default behavior is to SILENCE a nick!user@host pattern, and if such a pattern is not passed as 
the argument, it must be prepended with a plus ('+') to be added to your silence list. If a pattern is 
prepended with a minus ('-'), it will be removed from your silence list. If you only specify a nickname, 
you can list the patterns in the silence list owned by that nickname. If no arguments are given, your 
own silence list is displayed. 

See also: IGNORE, ACCEPT 

Squery 

/SQUERY <service> [<commands>] 
<service> -Service name 
<commands> - Commands to pass to the service. 
Works only on IRCnet. 

/SQUERY sends a query to the specified service. 
See also: SERVLIST, NOTE, LIST 
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Squit 



/SQUIT <server> | <mask> <reason> 

IRC Operator command. Splits the given server and all servers behind it from your side of the IRC 
network. 

See also: SCONNECT, OPER, DIE, RESTART 

Stats 

/STATS <type> [<server>] 

Shows some ire server usage statistics. Available types vary slightly per server; some common ones 
are: 

c - Shows C and N lines for a given server. These are 

the names of the servers that are allowed to connect, 
h - Shows H and L lines for a given server (Hubs and Leaves), 
k - Show K lines for a server. This shows who is not 

allowed to connect and possibly at what time they are 

not allowed to connect, 
i - Shows I lines. This is who CAN connect to a server. 
1 - Shows information about amount of information passed 

to servers and users, 
m - Shows a count for the number of times the various 

commands have been used since the server was booted, 
o - Shows the list of authorized operators on the server, 
p - Shows online operators and their idle times, 
u - Shows the uptime for a server. 

y - Shows Y lines, which lists the various connection 

classes for a given server. 
? - Shows information about servers connected to a server. 



Statusbar 

/STATUSBAR <name> ENABLE /STATUSBAR <name> DISABLE /STATUSBAR <name> 
RESET /STATUSBAR <name> TYPE wi ndow | root /STATUSBAR <name> PLACEMENT 
top | bottom /STATUSBAR <name> POSITION <num> /STATUSBAR <name> VISIBLE 
always | active | inactive /STATUSBAR <name> ADD [-before | -after <item>] 
[-priority #] [-alignment left | right] <item> /STATUSBAR <name> REMOVE 
<item> 

Commands for modifying the statusbar. 

/STATUSBAR - Display all statusbars. 

/STATUSBAR <name> - display elements of statusbar 
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Time 

/TIME [<server> | <nick>] 

This displays the time of day, local to the server queried (thus, the time returned may not be the 
same as the client's local time). 

If the server name is omitted, the client's current server is used. If a nickname is given, that client's 
server is queried. 

Same as /DATE. 

Toggle 

/TOGGLE <key> [on | of f | toggle] 

/TOGGLE < key > behaves like /SET <key> TOGGLE. also accepts arguments ON and 
OFF when/TOGGLEbehaves exactly like /SET. 

Rememberthat changes are not saved until you use /SAVE! 

See also: SET 

Topic 

/TOPIC [-delete] [<channel>] [<topic>] 
-delete - Deletes the topic. 

Shows or/and changes the topic of the current or specified channel. 

Trace 

/TRACE [<server> | <nick>] 

Without a specified server TRACE shows the current connections on the local server. If you specify a 
remote server it will show all servers between your current server and that remote server as well as 
the connections on that remote server. With a nick it shows the servers in between and information 
about that nick. 

On some servers, TRACE shows information such as IP addresses and idle times. 
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Ts 

/TS 

Shows topics of all channels you're on. 
See also: CHANNEL, TOPIC 
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Unalias 

/UNALIAS <alias> 
Removes an alias. 
See also: ALIAS 

Unban 

/UNBAN -first | -last | <id> | <masks> 
Removes the specified ban(s) from the channel. 
Examples: 

/UNBAN *!*@*.fi 

/UNBAN larry!*@* * ! me@* . mydomai n . net 

/UNBAN 3 - removes 3rd ban in list 

/UNBAN -first - removes 1st ban (equal to /UNBAN 1) 

/UNBAN -last - removes last ban in list 

See also: BAN, KNOCKOUT 



Unignore 

/UNIGNORE <id>|<mask> 

Unignores the specified userhost mask. If you want to unignore only some levels, use /IGNORE 
<mask> -<level>. 

See also: IGNORE 

Unload 

/UNLOAD <module> [<submodule>] 

Unload a running plugin. List of running plugins can be shown with / LOAD. 
See also: LOAD 
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Unnotify 



/UNNOTIFY <mask> 

Removes an entry from the notify list. 

See also: NOTIFY 

Unquery 

/UNQUERY [<nick>] 

Removes a query window of specified nick. 

See also: QUERY, SET QUERY 

Unsilence 

/UNSILENCE <nick!user@host> 
Works only in some IRC networks. 
Removes a pattern from your silence list. 
See also: SILENCE 

Upgrade 

/UPGRADE [<irssi binary path>] 

Upgrade irssi to new version on-the-fly without disconnecting from server, so other people 
won't even notice you quit from IRC. This ONLY executes the new binary, it does NOT down- 
load/compile/whatever irssi. 

Uping 

/UPING <server> 

IRC Operator command. Works only in the Undernet and Open Projects (ircu). 

This command works like the PING command (CTCP PING), except it is used on a server instead of a 
client. As with PING, it is used to test the relative distance another server is from you across the ire 
network. 

See also: RPING, OPER 

Userhost 

/USERHOST <nicks> 

Shows the user@host, IRC operator (*) and away (-) status of the specified nick. 
See also: WHOIS 
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Ver 

/VER [<nick> | <channel> | *] 

Sends a CTCP VERSION request to a nick or channel. This is used to find out which client and/or script 
the nick is using. 

See also: CTCP 

Version 

/VERSION /VERSION [<server> | <nick>] 

Shows the version info of the current or specified IRC server. 

See also: ADMIN, STATS 

Voice 

/VOICE <m'cks> 

Gives the voice (+v mode) to the nick(s) on the current channel. Wildcards in the nick are allowed. 
See also: DEVOICE, OP, DEOP 
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Wait 



/WAIT [-<server tag>] <nn Hi seconds> 
Wait for before sending the next command to server. 

This could be useful for example when identifying to NickServ; after sending the identify message 
you'd wait 3 seconds before joining to channels so any host changes are processed and you can join 
registered-only channels. 



Wall 



/WALL [<channel>] <message> 

This command sends a message to all operators in a channel. If the server supports WALLCHOPS 
or STATUSMSG=@, it sends a notice to @#channel. Otherwise it sends a notice separately to each 
operator, which may not be a very good idea to use in a channel with lots of operators. 



Wallops 

/WALLOPS <message> 
IRC operator command. 

This command sends the given message to everyone on the network who has user mode +w turned 
on. 

See also: OPER, WALLOPS 



Watch 

/WATCH [[+|-]<nick>] [ [+|-]<nick> ...] 
Works only in networks using Bahamut ircd. 

WATCH is somewhat equal to ISON/NOTIFY, but server-based. With WATCH server sends status in- 
formation to client, instead of client sending ISON's. Therefore WATCH is technically a bit smarter 
solution than ISON/NOTIFY. The only disadvantage is your WATCH list not being "saved". Once you 
disconnect, your WATCH list will get cleared. 
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WATCH is based on a nick, and must be prepended with a plus ('+') to be added to your watch list. A 
minus sign ('-') will remove an entry from the list. With no arguments, WATCH returns a list of your 
WATCH list entries. 

See also: NOTIFY, WHOIS, WHOWAS 



Who 



/WHO [<nicks> | <channels> | **] 

Without parameters, shows all users and their user infos on the current channel. If you specify a 
channel, shows all users on the given channel. 

If you specify an string with wildcards, you will be shown all users whose nick, userhost or realname 
matches the wildcard expression. 

If a channel is secret and you're not on it, you will not get any output. Otherwise if you're not on it, 
you will be shown only those channel members who do not have the invisible (+i) mode set. 

The flags field has the following meaning: 

H - The user is not away (here). G - The user is set away (gone). * - The user is an IRC operator. @ - 
The user is a channel op in the channel listed. + - The user is voiced in the channel listed. 

Examples: 

/WHO - Shows users on current channel 
/WHO #i rssi - Shows users on channel #irssi 

/WHO timo* - Shows users whose nick, userhost, or realname begins with string 'timo' 
See also: WHOIS, NAMES, CHANNEL 



Whois 

WHOIS [-<server tag>] [<server>] [<m'cks>] 

Shows whois information of the specified nick. By default, this is aliased to /VII. 

/WHOIS nickl ni ckl also queries the idle time of the user. This is aliased to /WII by default. 

If given nick is not in the IRC, irssi automatically sends a WHOWAS query. Read carefully the reply to 
see if it is a WHOIS or WHOWAS reply. 

See also: WHO, CHANNEL 



Whowas 

WHOWAS [<nicks> [<count> [server]]] 

This command is similar to WHOIS, except it returns information about nicknames that were recently 
in use. Like WHOIS, it shows the nickname, address, real name, and server. It may also return multi- 
ple entries if the nickname has been used recently by several people. These multiples may be limited 
by specifying a count to show. 

WHOWAS will work regardless of whether the queried nick is in use. If no arguments are given, the 
client's current nickname is used. 

Example: To show the last 5 users of the nickname JoeESob: 
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/whowas joebob 5 
See also: WHOIS 

Window 

/WINDOW LOG on | off | toggle [<fi lename>] 

/WINDOW LOGFILE <file> 

/WINDOW NEW [HIDDEN | SPLIT] 

/WINDOW CLOSE [<first> [<last>]] 

/WINDOW REFNUM <number> 

/WINDOW GOTO active | <number> | <name> 

/WINDOW NEXT 

/WINDOW LAST 

/WINDOW PREVIOUS 

/WINDOW LEVEL [<level>] 

/WINDOW IMMORTAL on | of f | toggle 

/WINDOW SERVER [-sticky | -unsticky] <t 

/WINDOW ITEM PREV 

/WINDOW ITEM NEXT 

/WINDOW ITEM GOTO <number> | <name> 

/WINDOW ITEM MOVE <number> | <name> 

/WINDOW NUMBER [-sticky] <number> 

/WINDOW NAME <name> 

/WINDOW HISTORY <name> 

/WINDOW MOVE PREV 

/WINDOW MOVE NEXT 

/WINDOW MOVE FIRST 

/WINDOW MOVE LAST 

/WINDOW MOVE <number> | <di rection> 

/WINDOW LIST 

/WINDOW THEME [-delete] [<name>] 
/WINDOW GROW [<lines>] 
/WINDOW SHRINK [<lines>] 
/WINDOW SIZE <lines> 
/WINDOW BALANCE 
/WINDOW HIDE [<number> | <name>] 
/WINDOW SHOW <number> | <name> 
/WINDOW UP 
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/WINDOW DOWN 

/WINDOW LEFT 

/WINDOW RIGHT 

/WINDOW STICK [<ref#>] [ON | OFF] 

/WINDOW MOVE LEFT 

/WINDOW MOVE RIGHT 

/WINDOW MOVE UP 

/WINDOW MOVE DOWN 

This command includes various subcommands for handling irssi windows. 

/WINDOW CLOSE - Closes the current window. 

/WINDOW MOVE #NUMBER| LEFT | RIGHT - Moves current window to another position in the win- 
dow list. 

/WINDOW GOTO #NUMBER- Moves into the specified window. 

/WINDOW GOTO ACTIVE - finds the first window with the higest activity (msgs to you -> msgs -> 
rest). Alt-A is the default shortcut key for this 

/WINDOW GOTO #CHANNEL | NICK | =NICK - moves you to the window with the channel, query 
or dec chat. 

/WINDOW LEVEL [+/-] PUB/MSGS/ .. . 

/window level msgs - creates messages window 

/window level all -msgs - creates status window 

/WINDOW NEW [HIDDEN | SPLIT] -creates new hidden/splitted window 

/WINDOW ITEM MOVE <number> | <name> -with a numeric argument, movesthe active window 
item of the active window to the window with refnum . with a string argument, moves the window 
item with name to the active window. 



Window logging 

/WINDOW LOG ON | OFF | TOGGLE [<fi lename>] - Start/stop logging the active window. This 
works exactly like 

/LOG OPEN -window 

/WINDOW LOGFILE <filename> - Sets the default log file to use in the window, it can be 
overridden by specifying the file name in /WINDOW LOG. If no file name is given, Irssi defaults to 
~/i rc . log. <wi ndowname> or ~/i rc . log . Wi ndow<ref #> if window doesn't have a name. 

See also: SET CREATE, JOIN, QUERY, LOG, LEVELS 



Wjoin 

/WJOIN With this you can join multiple channels in same window. This command does the same as 
/JOIN but it doesn't create a new window for the channel joined. 

See also: JOIN, WINDOW 
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Wquery 

/WQUERY 

Starts a query in the current window without opening a new window. 
See also: QUERY, WINDOW, SETAUTOCREATE 
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